home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / tls / tls074c.ltr < prev    next >
Text File  |  1995-07-20  |  5KB  |  191 lines
  1. IXI Visual Tcl
  2. ==============
  3.  
  4. Welcome to IXI Visual Tcl 1.0C1
  5.  
  6.  
  7. DESCRIPTION
  8. ===========
  9.  
  10. IXI Visual Tcl is a high-level graphical scripting language for graphical
  11. terminals. IXI Visual Tcl interprets commands and constructs graphical output
  12. using Motif, allowing the production of sophisticated graphical applications
  13. without the complexity of Motif.
  14.  
  15. IXI Visual Tcl is a multi-platform port of SCO Visual Tcl.
  16.  
  17.         
  18. INSTALLATION
  19. ============
  20.  
  21. To install IXI Visual Tcl, do the following:
  22.     
  23. 1. Choose a directory in which to install IXI Visual Tcl. The
  24.    recommended location is /opt, although you may choose a different
  25.    location if you wish. Move to this directory by typing:
  26.  
  27.       cd /opt
  28.  
  29. 2. Extract the software by typing one of the following:
  30.        
  31.     Solaris:  tar xvf cdromdir/IXIvt10s.tar
  32.     SunOS:      tar xvf cdromdir/IXIvt10x.tar
  33.  
  34.    replacing cdromdir with the name of your mount directory. See the
  35.    IXI Premier Motif Installation & Release notes for more information.
  36.  
  37. CONFIGURATION
  38. =============
  39.  
  40. If you installed IXI Visual Tcl in the recommended location, IXI Premier Motif
  41. configures all the appropriate environment variables automatically.
  42.  
  43. If you installed IXI Visual Tcl in a different location, you should do the
  44. following to correctly configure your system, replacing tcl_dir with the 
  45. pathname of the directory in which you installed IXI Visual Tcl:
  46.  
  47. 1. Add the bin directory to your PATH environment variable by typing one 
  48.    of the following:
  49.  
  50.     Bourne shell: PATH=tcl_dir/IXIvt10s/bin:$PATH ; export PATH
  51.     C shell:      setenv PATH tcl_dir/IXIvt10s/bin:$PATH
  52.  
  53. 2. Set the VTCL_HOME environment variable by typing one of the following:
  54.  
  55.     Bourne shell: VTCL_HOME=tcl_dir/IXIvt10s/lib/vtcl ; export VTCL_HOME
  56.     C shell:      setenv VTCL_HOME tcl_dir/IXIvt10s/lib/vtcl
  57.  
  58. 3. The remaining environment variables needed by IXI Visual Tcl can now
  59.    be set automatically by typing one of the following:
  60.     
  61.     Bourne shell: . $VTCL_HOME/sh-env
  62.     C shell:      source $VTCL_HOME/csh-env
  63.  
  64. TESTING 
  65. =======
  66.  
  67. A number of test scripts are provided to test every aspect of IXI Visual Tcl.
  68. These are located in $VTCL_HOME/tests. To run a test, do the following:
  69.  
  70. 1. Move to the tests directory by typing the following:
  71.     
  72.     cd $VTCL_HOME/tests
  73.  
  74. 2. Run the test suite program by typing the following:
  75.  
  76.     vtcl Browse.tcl
  77.  
  78. 3. You are presented with a list of test scripts. To view a test script,
  79.    click on its name in the list. To run a script, click on the Execute...
  80.    button. To quit the test suite, click on the Close button.
  81.  
  82. DEMOS
  83. =====
  84.  
  85. Demonstration programs are located in $VTCL_HOME/examples. To run a 
  86. demonstration program, do the following:
  87.  
  88. 1. Move to the examples directory by typing the following:
  89.     
  90.     cd $VTCL_HOME/examples
  91.  
  92. 2. Run the appropriate program by typing
  93.  
  94.     vtcl demo_name
  95.  
  96.    replacing demo_name with the filename of the demonstration program you 
  97.    wish to run.
  98.  
  99.  
  100. DOCUMENTATION
  101. =============
  102.  
  103. Documentation is provided in HTML format for viewing with IXI
  104. Mosaic. The documentation for IXI Visual Tcl appears as an entry in
  105. your Book List.
  106.  
  107. SUPPORT
  108. =======
  109.  
  110. All problems may be reported to IXI either by using the problem report form:
  111.  
  112.     http://www.ixi.com/support/bugreport.html
  113.  
  114. or by sending email to:
  115.  
  116.     support@x.co.uk
  117.  
  118. Please note however that IXI Visual Tcl is not a supported product.
  119.  
  120. IXI Visual Tcl HOME PAGE
  121. ========================
  122.  
  123. For up-to-date, complete information on IXI Visual Tcl, refer to 
  124. the IXI Visual Tcl home page:
  125.  
  126.     http://www.ixi.com/devt/vtcl/cover.html
  127.  
  128. or SCO Visual Tcl home page:
  129.  
  130.     http://www.sco.com/Products/vtcl/vtcl.html
  131.  
  132. Visual Tcl 1.0C1 RELEASE NOTES
  133. ==============================
  134.  
  135. 1) SunOS 4.1.x and Solaris 2.x:
  136.  
  137.     * There is no character based display engine.  Please ignore
  138.       all references to CHARM, and/or character display server in
  139.       the documentation.
  140.  
  141.     * There is no Help support available, except for Help ON_VERSION.
  142.  
  143.     * The dialog box options -apply and -cancel are only available for
  144.       VtFormDialog and VtFileSelectionDialog.
  145.  
  146.     * If for any reason Visual Tcl hangs, you may need to kill the daemon
  147.       server process and restart your application. This 
  148.       also terminates all current vtcl applications connected to the 
  149.       server.  To kill the daemon server process, do the following:
  150.  
  151.       1. To discover the process ID number of the daemon, type 
  152.          one of the following:
  153.  
  154.           Solaris: ps -elf | grep xm_vtcld
  155.           SunOS:   ps -aux | grep xm_vtcld
  156.  
  157.       2. Kill the process by typing the following:
  158.  
  159.         kill -9 pid
  160.         
  161.          replacing pid with the process ID returned by step 1.
  162.  
  163.  
  164. 2) SunOS 4.1.x only:
  165.     
  166.     * SunOS limits the number of IXI Visual Tcl shells that can be
  167.       run concurrently to 5. To run more shells concurrently, you
  168.       must increase the value of FIFOCNT and rebuild the
  169.       kernel. You should install patch number 100347 before
  170.       attempting to do this.
  171.  
  172.     * Problems may occur under SunOS if you do not exit your IXI
  173.       Visual Tcl shell cleanly. The VtClose command should always be used 
  174.       to exit a shell. Do not attempt to exit a Visual Tcl
  175.       application by sending signals such as SIGKILL or SIGSTOP.
  176.  
  177.       If for some reason you must terminate a script using a 
  178.           process ID, do the following:
  179.  
  180.       1. Identify the process by typing:
  181.  
  182.         ps -aux | grep vtcl
  183.  
  184.       2. Kill the process by typing:
  185.  
  186.         kill pid
  187.  
  188.          replacing pid with the process ID returned by step 1.
  189.          Note that you should not use `kill -9', as this may
  190.              hang the IXI Visual Tcl server.
  191.